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Understanding IRQs 


Why do they always lead to so many problems? .........:ccceeeeeeteeend 


IRQ stands for "interrupt request". You probably encountered it 
the first time you installed an expansion card ina PC. Julian Moss 
explains what IRQs are and why you can’t have more than one 
expansion card using the same IRQ. 
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Understanding PC Serial Ports 
Isia 16650 the answer 10: YOUN Prayers? -<cseccsnseciessinsciaacesnarannteasnsneacnarecens 9 


Julian Moss explains the concept of the serial port, as found on 
IBM compatible PCs, and offers some troubleshooting tips. 
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Re-engineering The Support Team 

Take a step back and look at the efficiency of your department............. 15 
Setting up a new PC support department? Considering reorganizing 

your existing one? Leigh Edwards offers some advice. 
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How To Write Computer Documentation 
If it’s not up to the job, no-one will read it 

It’s often the job of the support staff to produce written instructions 
on how to use hardware and software. Nick Barron and Wendy 
Grossman offer some advice on how to do it. 
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On This Month’s Utility Disk 


IRQ scanner for MS-DOS and Windows. 
Replacement serial comms driver for Windows. 
Enhanced viewers for PC Tools for Windows. 


Windows 3.x Frequently Asked Questions file. 


Not for filing 


"Going downmarket" - says Robert Schifreen. 


When I first started in this business in 
1983, there were two types of software 
house. The first type produced software 
(on audio cassette as well as floppy 
disk) for home computers. Mostly, 
these programs were just games. Good 
games, but games nonetheless. 


When users started to tire of games, the 
games software houses branched out 
into other types of software. Some pro- 
duced simple databases, which were 
marketed as being suitable to store de- 
tails of your friends’ names and ad- 
dresses, or your favourite recipes. 
Others produced very basic word pro- 
cessing applications. They had to be 
basic - few home computers had more 
than 64 KB of RAM, and that had to 
hold the program and the current do- 
cument. 


The second type of software house pro- 
duced software for businesses. Home 
software cost $20, whereas business ap- 
plications typically retailed for nearer 
$400. There were professional data- 
bases, spreadsheets, word processors 
and so on. 


The dividing line between the two 
types of software house was very clear. 
The games people didn’t try to compete 


with Lotus, and Ashton Tate didn’t sell 
Space Invaders. 


As the IBM-compatible PC starts to 
become the standard machine for both 
home and office, and with more and 
more people working from home, the 
big software companies are now diver- 
sifying into producing software specifi- 
cally for home use. WordPerfect started 
the trend a couple of years ago, by spe- 
cifically allowing users to take a copy of 
WordPerfect for use on a PC at home as 
long as the two copies were never in use 
at the same time. 


But now WordPerfect, Microsoft and 
Borland have gone one step further. 
They’re actively producing and market- 
ing distinctly branded programs for 
home users. WordPerfect has its Main 
Street brand, Microsoft has Microsoft 
Home, and Borland has announced 
Borland Simplify. WordPerfect’s Main 
Street programs are all less than $99 
retail, so traditional, expensive market- 
ing is out. 


Commercial users who trust their busi- 
ness to a major software company have 
a right to be concerned about the major 
players diversifying into the home mar- 
ket like this. Developing, marketing 
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and supporting $99 software is a com- 
pletely different ball game. 


Should we trust our companies’ com- 
puting to the people behind products 
such as Cap’n Karaoke? Are the big 
business software companies doing 
enough to convince us that they still 
want our money and that they still treat 
us seriously? 


Of course, I applaud the development 
of intelligent applications for children 
and for home use. But when I call for 
support on Excel, or to order some up- 
grades for Microsoft Office, [don’t want 
to speak to anyone that’s been within a 
mile of Creative Writer, Microsoft Di- 
nosaurs or Multimedia Beethoven. 


Youcan now contact the editor of 
PCSA via the Internet as 
pcsa-ed@oakworth.demon.co. 

_ uk. Feel free to mail us with com- 
ments, questions, or suggestions 


for future articles. 
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Understanding IRQs 


IRQ stands for "interrupt request". You probably encountered it the first time you 


installed an expansion card in a PC. Julian Moss explains what IRQs are and why 


you can’t have more than one expansion card using the same IRQ. 


( “rosea generally execute 
program instructions sequen- 
tially. Though a program may 

jump from one part of the code to an- 

other - the result of calling a subrou- 
tine or obeying an IF statement, 
perhaps - these changes in sequence 
are controlled by the program itself. 

Interrupts enable computers to re- 

spond to events external to the pro- 

gram, like a key being pressed or a 

character being received by a serial 

port. 


Event Driven 


The term "interrupt request" de- 
scribes exactly what IRQs are: a request 
for the processor to interrupt what it is 
doing, to deal with something else. IRQs 
are used by input devices like the key- 
board and the mouse, as well as less 
obvious things like the disk controllers 
and the system timer. 

Without interrupts, the only way to 
deal with external and often unpre- 
dictable events would be polling. 
Think of the PC as a house occupied 
by a family which has a servant. Using 
polling, the servant must walk round 
the house from room to room, check- 
ing to see if he is required to do 
anything. This wastes the servant's 
time and is not very dependable. Only 
by chance will the servant pop his 


head round the door at exactly the 
moment he is needed. And while he is 
busy doing one task he will not be 
checking to see if something more ur- 
gent needs doing elsewhere. 
Interrupt requests are a way of put- 
ting buttons in each room and a 
paging device in the servant's pocket. 
Now, when his assistance is required 
the pager beeps, and he can go straight 
to where he is needed. If, in the middle 
of performing the task, he is sum- 
moned by someone else, he can decide 
whether the request is more urgent. If 
it is, he can set aside the current task 
and respond quickly to the new one. If 
he has nothing to do, he can relax in- 
stead of continuing to wander round 
the house in case someone needs him. 


Urgent Requests 


Interrupts are the only practical 
way to handle events that must be 
dealt with urgently. An example of 
this is a standard serial port. This has 
no buffering: it can hold just one char- 
acter. If the processor does not read the 
character from the port and copy it 
intoa bufferin memory before the next 
one comes along, the data will be lost. 
Therefore when a serial portis used for 
input - when it is used with a modem 
ora mouse rather than, say, a printer - 
interrupt processing must be used. 


“Devices page the processor using 
interrupt request lines. The IRQ number 
identifies which request line is used. Each 

IRQ has a circuit trace connected to a 
contact on the expansion bus connector." 
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Interrupt Request Lines 


Devices page the processor using 
interrupt request lines. The IRQ num- 
ber identifies which request line is 
used. Each IRQ has a circuit trace con- 
nected to a contact on the expansion 
bus connector. To allow you to select 
which IRQ to use, a jumper or switch 
connects the expansion card’s inter- 
rupt signal to the chosen IRQ line. 

When the device wants to interrupt 
the processor it pulls the logic level of its 
IRQ line high, and holds it high until the 
interrupt has been acknowledged. The 
ISA bus uses edge- triggered inter- 
rupts: the low-to-high transition 
signals the interrupt request. 

MCA and PCI buses use level-sens- 
ing interrupts: the logic level on the 
IRQ line indicates an interrupt re- 
quest, not its low to high transition. 
Level-sensing is more reliable: with 
edge-triggering, noise on the bus may 
be mistaken for an interrupt; equally it 
is easier for a transition to be missed 
and an interrupt lost. 


Interrupt Controller 


An AT-compatible system has 16 
levels of hardware interrupts. How- 
ever, the processor itself has only two 
interrupt inputs. One is for the non- 
maskable interrupt (NMD), the other is 
for general interrupts (INTR). NMIs 
and IRQs are used for different things. 
An NMI will occur only if a serious 
hardware error such as a memory 
parity error is detected. 

To enable the processor to use its 
single INTR input to handle 15 inter- 
rupts, a chip called the programmable 
interrupt controller (PIC) is used. 
Originally, this was a discrete inte- 
grated circuit - an Intel 8259A. In 
modern PCs the interrupt controller is 
part of the PC’s logic chipset, though 
its functionality remains compatible 
with the Intel 8259A. 
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A single 8259A PIC chip can handle 
eight IRQ lines. In simple terms, the 
8259A converts an IRQ signal received 
on one of its inputs to an INTR signal, 
which is sent to the processor. At the 
same time, it places some data on the 
processor’s data bus which tells it 
where to find the instructions - the 
service routine - it needs to deal with 
the IRQ. This data is derived from the 
interrupt number (not to be confused 
with the IRQ number) which is pro- 
grammed into the PIC at start-up. 

In practice, the PIC does more than 
this. It allows interrupts to be enabled 
and disabled individually; this pre- 
vents the system crashes that would 
occur if a device generated an inter- 
rupt while its driver software was not 
installed. 

It also resolves the problem of what 
to do if one interrupt is received while 
another is being processed. The 8259A 
is programmed so that the first input 
line has the highest priority and the 
eighth has the lowest. If an interrupt 
occurs while a higher priority one is 
being dealt with, the chip won’t issue 
the INTR until it has been informed 
(by the other interrupt’s service rou- 
tine) that the earlier interrupt has been 
dealt with. 

Because the 8259A can only handle 
eight IRQ lines, two PICs are needed 
to support 15 IRQs. The second, or 
slave, PIC interrupts the processor via 
the first, or master, controller, using its 
IRQ2 input, as shown in Figure 1. This 
means that all of the eight inputs to the 
slave PIC have priority over the mas- 
ter PIC’s IRQs 3 to 7. 

IBM defined standard assignments 
for IRQs in AT-compatible systems. 
(EISA machines have greater flexi- 
bility if the EISA configuration utility 
is used.) A list of the standard inter- 
rupt assignments in priority order is 
given in Figure 2. Note that, of the 16 
interrupt levels (including NMI) sup- 
ported by the PC, only 11 are 
accessible to devices on the expansion 
bus. The others are in permanent use 
by the system. 


Using IRQ2 


Because IRQ2 is used by the slave 
interrupt controller, you may wonder 
whether or not you can use it. The IBM 
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"When the device-specific interrupt 


processing has been completed, the 


PIC is informed by sending it an end 


of interrupt code. This clears the 
appropriate bit in the IIR." 


Master 


PIC 


Interrupt 


NMI 
IRQO 
IRQI 
IRQ2 
IRQ8 
IRQ 
IRQ1O 
IRQI1 
IRQ12 
IRQ13 
IRQI4 
IRQU5 
IRQ3 
IROQ4 
IRQS 
IRQ6 
IRQ7 


Number Description 


02h 
08h 
09h 
OAh 
70h 
71h 
Ay 
73h 
74h 
75h 
76h 
77h. 
OBh 
OCh 
ODh 
OEh 
OFh 


Figure 2- An AT-compatible’s 16 interrupt levels, 


Memory parity check 

System timer 

Keyboard controller 

Used by second interrupt controller 
Real Time Clock 

Connected to bus pin B4 (PC bus IRQ2) 
unused 

unused 

unused 

Math Coprocessor 

Hard disk controller 

unused 

Serial port COM2 

Serial port COM1 

Parallel port LPT2 

Floppy disk controller 

Parallel port LPT1 


in decreasing order of priority 
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Figure 1 - Using two PICs to allow support for 15 IQS 


Available? 
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"When a device requires attention, it 
requests an interrupt by raising its IRQ 
line. This is detected by the PIC, which 
sets a bit in a register called the Interrupt 
Request Register (IRR) to show that an 
interrupt request has been received." 


XT, with its 8-bit expansion bus, had 
only one interrupt controller and eight 
IRQs. IRQ2 was accessible on the ex- 
pansion bus and available for use by 
peripherals. So many expansion cards 
are capable of being set up to use it. 

In an AT-compatible with an ISA 
expansion bus, IRQ9 is connected to 
the same pin on the bus as was used 
by IRQ2 in an XT. The BIOS redirects 
the interrupt processing for IRQ9 so 
that the IRQ2 interrupt handler is 
used. Thus, IRQ9 can be used exactly 
as if it were IRQ2. 

The only time you need be aware 
that IRQ2 is really IRQ9 is if you use a 
system interrogation utility to find out 
which IRQs are in use. IRQ2 will prob- 
ably be listed as "used by slave PIC". 
To check if interrupt processing is en- 
abled for your "IRQ2" device you 
should check the status reported for 
IRQ9 instead. 


The Interrupt Controller 


The two PICs are initialised at boot- 
up by the BIOS code. This code 
programs the interrupt numbers and 
the priority levels into each chip, and 
sets the Interrupt Mask Registers 
(IMR). 

The IMRs determine which inter- 
rupts are to be passed on to the CPU 
and which ignored. They consist of 
eight bits, each one corresponding to 
one of the PIC’s eight inputs. An inter- 
rupt is enabled when the 
corresponding mask register bit is set 
to Zero. 

The contents of the interrupt vector 
table are also initialised. This is a table 


which contains the locations in mem- 
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ory of the software (or BIOS firmware) 
routines that service each interrupt. 
The table is located right at the start of 
memory and contains a four byte ad- 
dress for every interrupt from 0 to FFh 
(255). For those interrupts which are 
not used, or at least not serviced by the 
BIOS, the table entry points to a "do 
nothing” routine. The BIOS sets up in- 
terrupt vectors and enables interrupts 
for those devices - like the timer, key- 
board and disk controllers - for which 
it provides service routines. The re- 
maining IRQs are disabled. 

Driver software for other devices 
must install their own interrupt vec- 
tors and enable the corresponding 
interrupt, and reverse these changes if 
the software is removed from mem- 
ory. 

When a device requires attention, it 
requests an interrupt by raising its IRQ 
line. This is detected by the PIC, which 
sets a bit in a register called the Inter- 
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rupt Request Register (IRR) to show 
that an interrupt request has been re- 
ceived. Like the IMR, the IRR has eight 
bits, each one corresponding to one of 
the PIC’s inputs. 

Next, the chip checks the IMR. If the 
corresponding bit is one, the interrupt 
is masked and nothing more is done. 
If itis zero, the chip then checks to see 
if a higher priority interrupt is in pro- 
gress. It does this by looking at another 
eight-bit register: the Interrupt In-ser- 
vice Register (ISR). Assuming that no 
bit corresponding to a higher priority 
interrupt is set, the PIC then places the 
address of the interrupt vector (which 
it calculates from the interrupt num- 
ber) on to the processor’s data bus, and 
interrupts the processor by issuing an 
INTR signal. 

When the processor receives the 
INTR, it responds by disabling inter- 
rupts - a second interrupt received at 
this stage would cause problems - and 
saves its status flags and the address 
of the next program instruction to be 
executed. It then acknowledges re- 
ceipt of the interrupt by issuing an 
INTA signal back to the PIC. This 
causes the corresponding bit in the ISR 
to be set. After that it starts executing 
the program instructions stored at the 
location pointed to by the interrupt 
vector. 

The interrupt service routine 
should begin by re-enabling inter- 
rupts, to allow a higher-priority 
interrupt to be dealt with as soon as it 
occurs. The contents of all the proces- 
sor registers should also be saved: 


File Utilities Help 
1 IRQ Status 
IRQ Address Description Detected Handled By 
@ 1B@6:6064 Timer Click Yes win386 .exe 
1 1A17:6187 Keyboard Yes UKKEYB 
2 @96B:@857 Second 8259A Yes Default Handlers 
3 @96B:@86F COM2: COM4: CcOM2 Default Handlers 
4 @96B:@887 COMi: COM3: CoML Default Handlers 
5 696B:669F LPT2: No Default Handlers 
6 @96B:88B7? Floppy Disk Yes Default Handlers 
? @@70:@6F4 LPT1i: Yes System Area 
8 @96B:6052 Real-Time Clock Yes Default Handlers 
9 F@@B:EED2 Redirected IRQ2 Yes BIOS 
10 @96B:@8CF (Reserved> Default Handlers 
11 @96B:@@E? ‘(Reserved> Default Handlers 
12 @96B:@@FF <Reserved> Default Handlers 
13 F@@@:EEDB Math Coprocessor Yes BIOS 
14 @96B:6117 Fixed Disk Yes Default Handlers 
15 F@@H:94BC (Reserved> 10S 
OK 


IRQ Status: Displays 


current usage of hardware interrupts. 
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Figure 3 - Output from the MSD Program 
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merely saving the flags and the next 
instruction address (which the CPU 
does automatically) is not sufficient to 
allow work to resume after the inter- 
rupt has been dealt with. The service 
routine should also acknowledge the 
interrupt request to the device, so that 
it can release the IRQ line and let it 
return to a state of logic low. 

When the device-specific interrupt 
processing has been completed, the 
PIC is informed by sending it an end 
of interrupt code. This clears the ap- 
propriate bit in the IIR. The program 
then restores the saved processor reg- 
ister contents and the processor flags, 
; : and returns to the sequence of instruc- 
Figure 4 - Output from Norton SysInfo tions that were originally being 
processed. 


stem Information 
System Disks Memory Benchmarks Help 


File 


Hardware Interrupts 


Address 


B 1B@6:4066 Timer Output 8 win386 

IRQ @1 1A17:6187 Keyboard UKKEYB 

IRQ @2 @96B:6057 [Cascade] 
: CcomM2 


Name 


Floppy Disk 
LPT1 
Realtime Clock 


IRQ @9 FGGG:EED2 Reserved BIOS 
IRQ 1@ G96B:@6CF Reserved DOs 


Previous 


1000 REM B, 


: program to list IRQ activation 


1010 1%=INP(&H21) -REM read first PIC IMR Processing Problems 

1020 FOR N%=0 TO 7 :REM check IRQs 0 to 7 Interrupts can be lost if they are left 
1030 GOSUB 1200 disabled for too long a period, perhaps 
1040 NEXT N% by a badly written program. This isn’t 


ee : common, though a few years ago a 
1060 I%=INP(&HA1) -REM read second PIC IMR version of the DOS KEYB utility 


1070 FOR N%=8 TO 15 ‘REM check IRQs 8 to 15 shipped with some machines was re- 
1080 GOSUB 1200 ported to cause problems for this 
1090 NEXT N% reason. If this is suspected as being the 
1100 SYSTEM cause of a problem, removing device 
1200 REM Subroutine to print IRQ status | drivers and TSRs from CONFIG.SYS 


1205 REM IRQ no. in N%, IMR in 1% and AUTOEXEC.BAT and then rein- 
i e ce stating them one by one may help to 

pepe aS NE ae ‘ | : pinpoint the offender. 

1230 IF N%=0 THEN PRINT "System Timer ; GOTO 1370 Interrupts are also disabled when 


1240 IF N%=1 THEN PRINT "Keyboard ", GOTO 1370 software puts the processor into pro- 
1250 IF N%=2 THEN PRINT "Slave PIC "; :GOTO 1370 tected mode. In protected mode, the 
1260 IF N%=3 THEN PRINT "Serial COM2 ". GOTO 1370 286 and higher processors can access 
1270 IF N%=4 THEN PRINT "Serial COM1 ". GOTO 1370 processor registers which are not 
1280 IF N%=5 THEN PRINT "Parallel LPT2 "; GOTO 1370 reac ee 
1290 IF N%=6 THEN PRINT "Diskette cntrller "; GOTO 1370 aede WaReRAe pe rouliies = wh ine 
1300 IF N%=7 THEN PRINT "Parallel LPT1 "7 (GOTO 1370 clude the PC BIOS - cannot be used in 
1310 IF N%=8 THEN PRINT "Real-time clock ", :GOTO 1370 protected mode, and disabling inter- 
1320 IF N%=9 THEN PRINT "Redirected IRQ2 "7, ;GOTO 1370 rupts is one way to ensure that they 
1330 IF N%=13 THEN PRINT "Maths coprocessor ",;GOTO 1370 aren't. 


1340 IF N%=14 THEN PRINT "Hard disk cntrller _"; GOTO 1370 For example, a disk cache may dis- 
1360 PRINT " i able interrupts while it copies data 


ie froma buffer in conventional memory 

1370 PRINT" -"; to the extended memory cache. The 
1875 1F (1% AND 1)=0 THEN PRINT "In use" ELSE PRINT "Not in use" interrupts may be disabled for long 
1380 I%=INT(I1% /2) enough to cause lost data from a fast 
1390 RETURN modem using an unbuffered serial 
o port. At 38,400 bps a serial port will 

generate, and require to be serviced, 


Figure 5- A simple Basic program to list IRQs. A compiled more than three interrupts every mil- 
version of this, in DOS and Windows forms, can be lisecond. Protected mode DOS 
found on this month's PCSA Utility Disk software - including Windows, and 
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"The contents of the interrupt vector 


table are initialised. 


This 1s a table which 


contains the locations in memory of the 
software (or BIOS firmware) routines 
that service each interrupt. The table is 
located right at the start of memory and 
contains a four byte address for every 
interrupt from 0 to FFh (255)." 


DOS programs that run under a DOS 
extender - work by trapping all inter- 
rupts. When one occurs, they must 
save the 32-bit processor status, switch 
the processor into real mode and then 
run the 16-bit interrupt handler. Inter- 
rupts must be disabled while this takes 
place, so again there is an increased 
risk of them being lost. Performance is 
also affected by the extra overhead in- 
volved. 

32-bit operating systems like OS/2 
and Windows NT replace the ROM 
BIOS with 32-bit software of their own. 
OS/2 and NT device drivers are de- 
signed to run in protected mode, so 
there is no need to keep interrupts dis- 
abled for long periods. 


IRQ Conflicts 


It is generally believed that ina PC, 
no two devices can share an IRQ line. 
This is not strictly true. In practice, 
however, if two devices share an IRQ 
they are unlikely to work. The fault is 
not that of the ISA bus, but of the ex- 
pansion board hardware and the way 
the driver software is written. 

To allow more than one device to 
use an IRQ line, expansion boards are 
not supposed to hold the line low 
when they are not requesting an inter- 
rupt. They are also supposed to check 
to see if the line is already high before 
requesting an interrupt. However, 
boards (including IBM’s own serial 
card) don’t often comply with this. 

Driver software usually makes the 
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same assumption. When an interrupt 
occurs, the service routine checks the 
status of the device, usually by reading 
a status register. If it doesn’t find any 
indication that the device issued an 
interrupt it may do nothing or even 
report an error. What it could do - but 
usually doesn’t - is transfer control to 
a second interrupt handler which 
looks after another device. 

Because of these limitations, itis not 
usually possible for more than one de- 
vice to use an IRQ. However, two 
boards can usually be installed and 
configured for the same IRQ, if only 
one of them will be active at any time. 

An example of this is a system 
which has more than two serial ports. 
Because only two IRQs are reserved 
for use by serial ports, only two serial 


System Timer 
Keyboard 

Slave PIC 

Serial COM2 
Serial COM1 
Parallel LPT2 
Diskette cntrller 
Parallel LPT1 
Real-time clock 
Redirected IRQ2 


WODAIHDUSPWNHERO 


Maths coprocessor 


: \PROG\BASIC> 


devices can use interrupt processing. 
If you have a mouse on COM1, and 
therefore using IRQ4, a modem or fax 
card must use IROQ3. However, DOS 
uses polling for its standard devices, 
so it is possible to use serial ports as 
standard DOS devices at the same 
time as their IRQs are being used by 
something else. 


Determining IRQs In Use 


In general, it is best to stick to the 
rule of one IRQ per device. This means 
that you need to identify what IRQs 
are already in use before installing a 
new board. 

There are many system interroga- 
tion utilities which claim to be able to 
identify what hardware interrupts are 
used in a system. However, the infor- 
mation they provide is misleading and 
often inaccurate. Figure 3 shows the 
output from the Microsoft diagnostics 
utility MSD. This fails to show that 
IRQ10 is being used by a CD-ROM 
drive in the system from which the 
screenshot was taken. Figure 4 shows 
the output from Norton’s SYSINFO 
which is not much better, though it 
does give a clue to whether the IRQ is 
in use by showing the memory ad- 
dress its interrupt vector is pointing to. 

In general a PC provides only two 
clues as to whether an IRQ is in use: 
the contents of the interrupt vector and 
the state of the PICs’ interrupt mask 
registers. The master PIC’s IMR can be 
obtained for examination by reading 
I/O port 21h, and the slave’s by read- 


- Not in use 
- Not in use 


- In use 
Hard disk cntrller - In use 
- Not in use 


Figure 6 - Output from the Basic program shown in Figure 5 
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"An AT-compatible system has 16 levels 
of hardware interrupts. However, the 
processor itself has only two interrupt 

inputs. One is for the non-maskable 
interrupt (NMI), the other is for general 
interrupts (INTR). NMIs and IRQs are 
used for different things. An NMI will 
occur only if a serious hardware error 
such as a memory parity error 1s detected." 


ing port Alh. Determining which in- 
terrupts are enabled is then simply a 
matter of looking at which bits are set 
in each byte. One of the few diagnostic 
software packages that actually does 
this is Diagsoft’s QAPlus/FE. 

The program listing in Figure 5 
shows how it is done. It is written in 
standard Microsoft BASIC, and can be 
run using the GWBASIC or QBASIC 
interpreters supplied with MS-DOS. 
The program is simplified by making 
the assumption that it will not be run 
onan XT-compatible system with only 
one interrupt controller. 

The BASIC program decodes the 
interrupt mask registers by gradually 
shifting the bits right and testing if the 
least significant bit is zero, which indi- 
cates that the IRQ is in use. An 
example of output from the program 
is shown in Figure 6. Executable ver- 
sions for both DOS (IRQ.EXE) and 
Windows (IRQWIN.EXE) are also in- 
cluded on the PCSA Utility Disk. 

However, no software utility can 
detect whether an IRQ is in use unless 
the device’s driver software is active. 
If it isn’t, there will be no service rou- 
tine for the interrupt vector to point to, 
and the PIC’s mask register will show 
the IRQ as disabled. So interrogation 
utilities are of limited use. 

If you do wish to identify what 
IRQs are used without opening the 
box then you must ensure that the 
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driver software for any device in- 
stalled in a machine is running. In the 
case of, say, a network card, this will 
not be difficult as the network soft- 
ware runs as a memory resident TSR, 
and you can simply run your diagnos- 
tic utility from the DOS prompt. For 
some other hardware, such as a tape 
backup unit with its own interface 
card, the driver software may be part 
of the backup program. To allow a 
diagnostic utility to identify the IRQ 
used, you will need to run it while 
shelled to DOS from within the soft- 
ware. 

Note also that Windows may give 
a different picture of IRQs in use to 
DOS. For example, if you have a serial 
mouse but don’t load a DOS mouse 
driver, the IRQ used by the serial port 
will not be shown as in use, even when 
you run the interrogation software 
from a DOS session within Windows. 

In the end, there is no substitute for 
getting the screwdrivers out and look- 
ing inside the box to see exactly what 
is installed and how it is set up. Diag- 
nostic utilities have their uses - but 
only as long as you realise their limita- 
tions. 


Conclusions 


Interrupts enable PCs to deal with 
asynchronous events without the 
overhead associated with polling. 
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Consequently, almost all add-in 
boards use an IRQ line as their means 
of gaining the attention of the proces- 
sor. 

Though it is possible for two or 
more boards to share an IRQ, because 
of the way most PC add-in boards and 
driver software are designed, the 
cardinal rule of one IRQ per device 
should always be observed. Where 
unused IRQs are in short supply, it is 
possible to gain extra flexibility by 
making use of IRQs reserved for other 
devices, if those devices are not going 
to be used at the same time, or are 
polled rather than interrupt driven. 

Software utilities such as MSD, 
Norton’s SYSINFO and Checkit PRO 
are of limited usefulness in determin- 
ing what hardware is installed in a PC 
and which IRQs are used. However, 
utilities that read the contents of the 
interrupt controllers’ mask registers 
can be used as long as you ensure that 
any interrupt-driven devices are ac- 
tive at the time. 
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Understanding PC 
Serial Ports 


Julian Moss explains the concept of the serial port, as found on IBM 


compatible PCs, and offers some troubleshooting tips. 


Ts serial port is one of the most 
useful I/O ports on a PC. How- 
ever, although the design and 
power of PCs has changed markedly 
over the years, the serial port has 
changed hardly at all. This has become 
a problem in some areas, particularly 
modem communications, where the 
dramatic increase in data rates used 
has made the standard serial port 
somewhat inadequate. 

Though the PC’s serial port hard- 
ware is theoretically capable of 
supporting a maximum rate of 115,200 
bps, it was never intended to be used 
above 9600 bps. By using a faster chip, 
IBM later relaxed this restriction, 
allowing speeds of up to 19,200 bps on 
the PS/2. But the latest fast modems 
need to communicate with the PC at 
up to 57,600 bps to achieve their best 
performance; at these speeds the per- 
formance of the standard serial port 
and many communications programs 
is inadequate. (Remember that a 
modem running at, say, 38400 bps and 
using built-in compression will be re- 
ceiving data from the remote system at 
38400 bps but, once the modem has 


uncompressed the data, it will need to 
send it back to the PC at a greater 
speed than 38400 bps in order to pre- 
vent its buffers from overflowing.) 

The problems of reliable high- 
speed communication are made worse 
by the fact that communications soft- 
ware often has to multitask alongside 
disk caches, network drivers and other 
Windows or OS/2 applications. 

In this article, we will look at the 
basics of serial communications and 
how PC serial ports work. We will 
describe the different types of serial 
port hardware, how to identify them, 
and what their implications are for 
communications performance. 


Serial Communications 


As the name implies, in serial com- 
munications the bits that make up the 
bytes or characters of data are trans- 
mitted serially, one after another, over 
the communications medium. This 
means that a communications circuit 
can consist of a minimum of just two 
wires: a signal line and a return. A PC 
needs three wires for two-way com- 


"The most common instance of having 
more than two serial ports in a 
PC is when an internal fax or data 
modem is installed. Such modems contain 
a chip which emulates a standard 
UART, and are configured to look 


like an ordinary serial port.” 
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munication, because the transmitted 
and received data use separate lines; 
this makes simultaneous (full duplex) 
communication possible. 

The serial port on a PC conforms to 
the US Electrical Industry Association 
(EIA) Recommended Standard 232C 
(RS-232C). This defines a number of 
signal lines besides those which carry 
data: those that determine whether the 
linked devices are ready to communi- 
cate (Data Set Ready, Data Terminal 
Ready, Data Carrier Detect), those that 
implement a protocol for communica- 
tion (Request to Send, Clear to Send), 
and a few other things, some of which 
are rarely used on a PC. The RS-232C 
signals and their pin assignments on 
the PC serial port sockets are shown in 
Figure 1. 

The RS-232C standard also defines 
the voltage levels used over the link. 
These are from -3V to -15V (nominal 
-12V) for a 1 (mark) and +3V to +15V 
(nominal +12V) for a 0 (space). This 
wide separation of voltages gives the 
serial interface a high immunity to 
noise, and means that serial data can 
be transmitted reliably over long cable 
runs. 

Unfortunately, these signal levels 
require +12V and -12V supply volt- 
ages to be provided within the 
communications hardware. This is not 
a problem for desktop systems: a small 
amount of power at these levels is pro- 
duced by the PC’s power supply. 
Portables, however, typically run from 
batteries with an output voltage of 6V 
or less. Their serial ports may use or- 
dinary logic levels of +5V and OV, or 
even +3.3V in the case of the latest low 
power systems. Older serial devices, 
including mice - which draw their 
operating power from one of the sig- 
nal lines - may not work at these lower 
voltage levels. 


File: H0815.1 


Hardware:Tutorial 


"The serial port's eight registers 
give programmers a high degree of 
control over the speed and format of the 
serial data, the status of the other 
RS-232C signal lines, and the way in 
which data and errors are handled." 


PC serial ports can only be used for 
asynchronous communication. Asyn- 
chronous means that characters are 
transmitted as and when they are 
available to be sent. Most mainframe 
terminal links, particularly in Europe, 
use synchronous communication in 
which data is transmitted in blocks 
with error checking, using a proprie- 
tary protocol. For this, a 
special-purpose communications 
adapter is needed. 

Using an asynchronous link, the 
line is maintained ata mark, or logic 1, 
level while it is idle. As soon as a char- 
acter is ready to be transmitted, a start 
bit of zero or space is sent. The data 
then follows. Data may optionally 
contain a parity bit. Mainframes com- 
monly use 7-bit data words with even 
parity. PCs, however, use the ex- 
tended ASCII character set, so 8-bit 
words are used and parity is omitted. 
One or two stop bits are sent to indi- 
cate the end of each character. An 
example is shown in Figure 2. 


Speeds 


Serial data can be sent at any speed, 
though in practice certain speeds have 
been adopted as standard. It is import- 
ant that both the receiver and the 
transmitter are set to use the same 
speed. Because there are no synchroni- 
sing clock pulses, the receiver will start 
counting off the bits from the moment 
the start bit is received. If it is fast or 
slow relative to the sender, by the end 
of the word it may be reading the 
wrong part of the incoming signal. 
Start and stop bits allow the receiver to 
resynchronise at the start of each char- 
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acter, so this problem should not occur 
unless there is a big discrepancy be- 
tween sender and receiver. 

Most of the time, the data format 
used for serial communication using a 
PC is one start bit, eight data bits (or 
seven plus parity) and one stop bit - a 
total of 10 bits per character. This 
makes it easy to work out the maxi- 
mum transfer rate of a serial port in 
characters per second: take the bps set- 
ting of the port and divide by 10. 


Pin25 Pin9 Signal Name 
Protective Ground 
Transmitted Data 
Received Data 
Request to Send 
Clear to Send 
Data Set Ready 
Signal Ground 


WAND PWNH 


Not used 
Not used 
elect Standby 
Not used 
Not used 
Not used 


Not used 


Test 

Not used 

Data Terminal Ready 
Not used 

Ring Indicator 

Speed Select 

Not used 

Not used 


Revd Line Signal Detect 


Configuration 


The component which handles the 
transmission and reception of data 
over a serial link is a chip called the 
Universal Asynchronous’ Re- 
ceiver/Transmitter (UART). The 
serial communications adapter made 
by IBM for the original PC used a Na- 
tional Semiconductor NS 8250 chip, 
and for reasons of backward compati- 
bility this chip defines the standard 
functionality for serial ports in PCs. 

The 8250 chip is controlled by 
means of eight registers which are ac- 
cessible as I/O ports. Additional logic 
on the board makes these registers ap- 
pear at I/O addresses 3F8h - 3FFh for 
serial port 1, and 2F8h - 2FFh for serial 
port 2. 

Many serial boards also allow the 
ports to be configured to appear at the 
alternative addresses of 3E8h - 3EFh or 
2E8h - 2EFh, allowing the PC to have 
a maximum of four serial ports. 
Though this is an accepted conven- 
tion, it was never defined by IBM. A 
third serial port will be called COM3 


From Modem To Modem 


(GND) 
(TD) 
(RD) 
(RTS) 
(CTS) 
(DSR) 
(SG) 
(DCD) 


Transmit Signal Element Timing 


Receiver Signal Element Timing 


(DTR) 


(RD 


Figure 1 - Serial Port Pinouts 
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"The NS 8250 UART and its successor 
usually used in AT-compatible systems, 
the NS 16450, has no internal buffering, 
so if an incoming character is not copied 

to memory before another character is 
received, it will be irrevocably lost." 


by DOS, regardless of which I/O ad- 
dresses are used. 

Optionally, the serial adapter may 
be configured to generate an interrupt 
whenever a character is received, 
when it is ready to accept a character 
for sending, when there is a change in 
one of the line status signals or when 
an error occurs. Only two interrupt 
levels are available: IRQ 4 for serial 
port 1 and IRQ 3 for serial port 2. This 
means that even if you have three or 
four serial ports installed, only two of 
them can be used with software that 
uses interrupt processing. 

The most common instance of hav- 
ing more than two serial ports in a PC 
is when an internal fax or data modem 
is installed. Such modems contain a 
chip which emulates a standard 
UART, and are configured to look like 
an ordinary serial port. Because most 
PCs have two serial ports already, you 
must either disable one of them, or set 
up the modem to use one of the alter- 


native I/O address blocks mentioned 
above. 

A few designs of modem allow 
other IRQ levels than 3 or 4 to be used, 
such as IRQ 5 which is reserved for, 
but rarely used by, a second printer 
port. Whether you can take advantage 
of this capability will depend on the 
flexibility of the setup options of your 
software. 


Controlling the UART 


The serial port's eight registers give 
programmers a high degree of control 
over the speed and format of the serial 
data, the status of the other RS-232C 
signal lines, and the way in which data 
and errors are handled. The UART 
supports word lengths of 5 to 8 bits, 
one or two stop bits (1.5 in the case of 
5-bit words) and odd, even, forced 
zero, forced one, or no parity. 

The data rate is set by loading two 
eight-bit values into two of the regis- 


Mark [1] 


Space (0) 


Data word 


ters, to form a 16-bit divisor. The VART 
is driven by a 1.8432 MHz clock crystal. 
The data rate is determined by the clock 
frequency divided by the divisor, 
divided by 16. A value of 12 (0Ch) 
would be used to obtain 9,600 bps. 

The maximum possible speed is 
115,200 bps (1843200/16), using a di- 
visor of one. However, this is a 
by-product of the way the hardware 
has been designed, rather than a fea- 
ture. The serial port was never 
designed to be used at such speeds and 
you should not expect reliable com- 
munication to be obtained using 
ordinary communications packages. 
Software such as LapLink which runs 
serial ports at this speed must use 
special programming techniques in 
order to do so. 

Other UART registers allow pro- 
grammers to set the state of the RTS 
and DTR lines, and to test the state of 
the CTS, DSR, RI and DCD lines. It is 
worth pointing out that the PC serial 
adapter is not intelligent. Though the 
RS-232C specification defines how the 
signal lines should be used to control 
communication between a terminal 
and a communications device - a pro- 
cess known as handshaking - 
implementation of the correct hand- 
shaking protocol is entirely the 
responsibility of the software used to 
drive the serial port. The RTS and DTR 
lines which can be controlled by the 
PC may be used for any purpose what- 
ever: for example, to control an 
electronic switch to turn on and off an 
external device. 

One register bit can be used to con- 
trol a loop-back function within the 
UART. This can be used by diagnostic 
software to test the UART for correct 
internal operation. 


Interrupt Handling 


An important factor affecting the 
speed and reliability of serial com- 
munications is the way software 
handles the sending and receiving of 
data. When a character is received, the 
UART sets the Receive Data Ready bit 
in its Line Status Register (LSR). A pro- 
gram wishing to read data from the 
serial port could simply loop while test- 
ing the value of this bit. As soon as the 


bit is set, the program could read the 


Figure 2 
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byte from the data register, and copy 
it into a buffer in the PC’s memory. 

Note that the NS 8250 UART and its 
successor usually used in AT-com- 
patible systems, the NS 16450, has no 
internal buffering, so if an incoming 
character is not copied to memory be- 
fore another character is received, it 
will be irrevocably lost. 

To send a character, a program 
could loop while testing the value of 
another line status bit which indicates 
whether the Transmit Holding Regis- 
ter is empty. When the register is 
empty, a byte can be written to it ready 
for transmission. 

This method of driving a device is 
called polling. Itis the method used by 
MS-DOS to drive the serial ports when 
they are accessed as standard DOS de- 
vices such as COM1. However, for 
general purpose communications soft- 
ware, polling cannot be used as it is 
impossible to ensure that the proces- 
sor will always be able to respond to 
an incoming byte of data in time to 
prevent it from being overwritten by 
the following one. 

Software which is designed to be 
used at higher data rates must make 
use of the serial adapter’s ability to 
issue an interrupt request whenever a 
character is received. Generally, it will 
use an interrupt handler to deal with 
transmission, protocol and error re- 
porting as well. 

One of the UART’s eight registers is 
the Interrupt Enable Register (IER). 
This allows the controlling software to 
specify what conditions should cause 
the chip to generate an interrupt. 
There are four possibilities: when a 
character has been received, when the 
transmit holding register is empty, 
when one of the modem status signals 
has changed state, or when an error 
has been detected in the received data. 

Software can initialise the IER by 
writing to it a byte in which one bit is 
set for each of the four options above 
that are to be enabled. A second bit 
(OUT 2) must also be set in the Modem 
Control Register; this controls 
whether the interrupt is passed to the 
IRQ line on the PC expansion bus. 

For interrupt processing to begin, 
the appropriate IRQ must also be en- 
abled in the Interrupt Mask Register of 
the PC’s interrupt controller. 
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"As the name implies, in serial 
communications the bits that make up the 
bytes or characters of data are transmitted 

serially, one after another, over the 
communications medium." 


When one of the conditions men- 
tioned above occurs, an interrupt will 
be generated. This will cause the pro- 
cessor to begin executing an interrupt 
service routine which must also have 
been installed by the software. The in- 
terrupt routine can determine which 
of the conditions caused the interrupt 
by reading the Interrupt Identification 
Register. It can then take the appropri- 
ate action depending on the result. 

The important thing to note here is 
that the PC can be processing other 
work: the interrupt will notify the pro- 
cessor as soon as a Serial port event 
occurs that needs to be dealt with. As 
long as the PC is able to respond to 
interrupts - if interrupts are not dis- 
abled, and the processor is not 
processing a higher priority interrupt 
- it need take just a few tens of CPU 
cycles to respond to an interrupt from 
a serial port. 

In practice, however, this is often 
not the case. Interrupts are frequently 


disabled for short periods when other 
non-interruptible work is carried out 
by the CPU. In addition, the system 
may often be processing other, higher 
priority devices. Only the parallel 
ports and floppy disk controller have 
a lower priority than the serial ports. 

In addition, there is an increasing 
tendency to write device drivers in a 
high level language like C rather than 
assembler. This makes them less effi- 
cient, in that it takes more machine 
instructions to deal with an interrupt. 
Interrupts are therefore likely to be 
disabled for longer. 

At 19,200 bps a serial port will 
generate an interrupt every 52 micro- 
seconds. This is roughly the time 
needed to execute 1,000 machine in- 
structions on a 66 MHz processor, and 
should be ample to allow each charac- 
ter to be processed, as long as the 
communications software is well writ- 
ten, there is not too much other 
background activity taking place, and 


File Utilities Help 
Computer... American Megatrend Disk Drives... A: B: CC 
COM Ports 
COM1: COM2 COM3 com4 
Port Address O3F8H O2F8H N/A N/A 
Baud Rate 1200 2400 
Parity None None 
Data Bits it 8 
Stop Bits 1 of 
Carrier Detect (CD) No No 
Ring Indicator (RI) No No 
Data Set Ready (DSR) No Yes 
Clear To Send (CTS) No No 
UART Chip Used 8250 8250 
OK 
Other Adapters... Device Drivers... 
COM Ports: Displays status of serial ports. 
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no badly behaved software which dis- 
ables interrupts for long periods is 
used. 


Communications errors 


Higher communications rates and 
slower processors will both increase 
the chances of missed characters oc- 
curring by reducing the time available 
to respond and increasing the time it 
takes. You may also become aware of 
differences between the efficiency of 
different communications programs: 
one program may work well at 19,200 
bps while another might only manage 
9,600 bps. The maximum rate useable 
under DOS will probably be greater 
than that under Windows, because 
there is less other activity going on. 

Disk activity, and in particular disk 
caching, can affect the reliability of file 
downloads at high communications 
speeds. Not only does the disk controller 
have a higher priority than the serial 
port, disk caches frequently cause in- 
terrupts to be disabled for lengthy 
periods. Expanded memory managers 
are another common culprit. 

A good communications program 
will avoid the possibility of interrupts 
being lost while data is written to disk 
by using handshaking to suspend the 
reception of data while disk writes are 
taking place. However, a disk cache 
which uses delayed writes can wreck 
this strategy by causing the actual 
writes to take place a few seconds 
later, outside the control of the com- 
munications program. You may find 
that disabling caching allows your 
communications software to work re- 
liably at higher speeds. 

The UART is able to report a num- 
ber of error conditions using bits in its 
Line Status Register. These bits are in- 
formational: it is not necessary for 
software to act upon them and many 
communications programs have the 
option to turn off serial port error re- 
porting. 


Error Types 


If you do enable error reporting, 
then you will find that there are three 
types of error. An overrun error occurs 
when the data in the receive data reg- 
ister was not read before it was 
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overwritten by the next byte to be re- 
ceived. This frequently occurs when 
interrupts are missed or the system is 
unable to respond to them in time due 
to the reasons described above. 

A parity error may occur if you 
have selected a data format with odd 
or even parity, and a byte is received 
in which the parity is found to be in- 
correct. A framing error occurs if the 
received data did not havea valid stop 
bit. This is normally a result of the 
receiver being set to the wrong speed. 


Buffered UARTs 


The problem of lost characters can 
be avoided by using a later type of 
UART chip, the NS 16550. This chip is 
backwards compatible with the 8250 
and 16450, and can be fitted as a direct 
replacement for it. Itsadvantage is that 
it contains a 16-byte first-in first-out 
(FIFO) buffer which can be used to 
store outgoing or incoming data. 

The 16550 can be programmed to 
interrupt the processor only after 1, 4, 
8 or 14 bytes have been processed. By 
interrupting the CPU less often, more 
time is left for it to perform other work. 
At the same time, the FIFO buffer 
makes it much less likely that incom- 
ing data will be lost. 

If your serial board has a socketed 
8250 or 16450 UART fitted, upgrading 
to a buffered serial port is a simple 
matter of replacing the old chip witha 
16550. The chip costs around $15 from 
electronic component suppliers. The 
bad news is that upgrading isn’t 
usually that easy. 

Most systems don’t havea separate 
UART at all. Instead, the functionality 
of a pair of 8250s or 16450s is incorpor- 
ated into a multi-I/O chip which also 
includes a parallel port, and possibly 
the floppy and IDE disk interface as 
well. To upgrade most PCs, you will 
need to either disable an existing serial 
portand install a new serial board con- 
taining a 16550 UART, or alternatively 
replace the entire multi-I/O board (if 
a separate board is used, as in most 
systems) with one incorporating 16550 
functionality. The latter are becoming 
increasingly common, and will prob- 
ably be the cheapest way to add a 
buffered serial port to a PC. 

A third option is to buy an internal 
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modem which incorporates a buffered 
UART. Most high-speed internal 
modems now do, and so this could be 
the simplest option. 

Making use of the buffered UART 
may take a little more work. Most com- 
munications software takes advantage 
of the FIFO buffer without modifica- 
tion. However, packages that haven’t 
been written to recognise the chip will 
require the buffer to be enabled by 
means of an external utility. This sim- 
ply writes the appropriate settings 
into one of the chip’s control registers. 

A few communications packages 
have been reported to crash when the 
FIFO buffer is enabled. As buffered 
UARTs become more common (many 
new PCs are now fitted with them as 
standard) more software should 
become compatible with them, so if 
this is the case it would be worthwhile 
enquiring about updates. 

Under Windows 3.1, the serial port 
may be reported as unavailable if the 
FIFO buffer is enabled before loading 
Windows. Communications software 
that is 16550-aware may still be able to 
use it, however. To inform the Win- 
dows serial port driver that a buffered 
serial port is in use you should ensure 
that there is a COMnFIFO=1 com- 
mand in the [386Enh] section of 
SYSTEM.INI, where nis the COM port 
number of the port. 

Make sure that you are using the 
latest version of the serial port driver 
SERIAL.386. There is a bug in the one 
distributed with Windows for Work- 
groups 3.11 (though Microsoft claims 
the bug is in the chip, not the driver) 
which can cause the system to hang in 
certain circumstances. An update is 
available (WG1001, dated 3/94). [This 
is also on this month's PCSA Utility Disk 
- Ed.] 


Solutions 


If you want to take advantage of the 
16550 from both Windows and DOS 
then the best solution is probably to 
use TurboCom. This is a replacement 
Windows driver which costs $47.50 
and is available from Bio-Engineering 
Research Laboratories, 180 Beacon 
Hill Lane, Ashland, OR 97520, USA 
(Tel: +1 503 482 2744). 

Alternative, but more expensive 
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solutions are offered by the use of in- 
telligent serial boards. One example is 
the Hayes Enhanced Serial Port. This 
uses two 16550 chips, but has its own 
on-board processor and buffering, so 
performance is independent of any- 
thing else that is happening in the 
machine. 

Another example is the IBM Type 3 
serial port fitted to the more powerful 
variants of the PS/2 range. This adds 
to the benefit of a FIFO buffer by pro- 
viding DMA access so that data can be 
loaded directly into memory without 
processor intervention. The clock 
speed of the UART is also increased, 
offering a maximum supported data 
transfer rate of 345,600 bps. 

The disadvantage of both these 
types of enhanced serial port is that 
specific support needs to be added to 
the driver software to take advantage 
of their capabilities. This support is 
likely to be lacking in most DOS 
comms packages. Under Windows or 
OS/2 the support is provided by a 
driver supplied with the board, which 
then delivers enhanced performance 
to all communications packages that 
run under the environment. 


Identifying UARTs 


Many different variants of UART 
chips have been used in PCs over the 
years. The NS 8250 defines the basic 
functionality of a PC serial port, and 
was the standard for PC-XT com- 
patible systems. Later versions of the 
chip - the 8250A and 8250B - simply 
correct minor bugs in their operation. 
The 8250 chips should work at up to 
9,600 bps. 

The NS 16450 is a higher-speed ver- 
sion of the 8250, but in other respects is 
the same as an 8250A. It was selected by 
IBM for use in the PC-AT, and its higher 
speed allowed IBM to quote a maxi- 
mum supported speed of 19,200 bps. 

The NS 16550 buffered UART was 
first used in early models of the IBM 
PS/2. However, this version of the 
chip had a bug which prevented its 
FIFO buffers from being used. It is 
therefore effectively a 16450, and 
limited to 19,200 bps. 

The bug was corrected in a later 
version: the NS 16550A. The chip has 
gone through a number of revisions. 


The latest version is the NS 16550AEFN, 
and this is the one to look for to be 
assured that it will work with the 
widest range of hardware and soft- 
ware. 

UARTs compatible with the Na- 
tional Semiconductor chips are made 
by other chip manufacturers. In addi- 
tion, there is an even greater number 
of multi-[/O chips that integrate 
UARTs with other functions. Identifi- 
cation of the type of UART in a PC is 
therefore often not possible by inspec- 
tion. 

Identification by software is also 
difficult, since many diagnostic 
utilities fail to differentiate between 
the different versions of the three types 
of chip. In particular, a buffered UART 
may appear to be a 16550, but could 
contain a bug that prevents operation 
in certain situations. 


Diagnostic Software 


The most readily-available tool for 
identifying the type of UART installed 
in a PC is the Microsoft Diagnostics 
(MSD) whichis shipped with all recent 
Microsoft products. Run MSD.EXE 
and then choose the COM port screen: 
the type of UART is given on the last 
line of the listing, as shown in Figure 
3. The UART will be identified as 
either 8250, Unknown, 16550 or 
16550AF. 

To test the performance of the buf- 
fered UART, you can use the Norton 
Diagnostics (NDIAGS) program 
which comes with The Norton Utilities 
version 7.0 and later. Under the Com- 
prehensive test menu, you will find a set 
of tests labelled 16550A Serial Port Test. 
These tests will only be enabled if the 
program detects a buffered serial port. 

To run the NDIAGS tests you will 
need a loopback plug attached to the 
serial port, which must be wired as 
shown in the READ.ME file that ac- 
companies the package. The program 
runs a Series of tests at speeds of 9,600 
bps, 19,200 bps, 38,400 bps, 57,600 bps 
and 115,200 bps, with the chip pro- 
grammed to interrupt after 1,4, 8 or 14 
bytes have been received. 

The results show the data rate 
achieved, and also how many charac- 
ters were read from the FIFO buffer 
when the interrupt was processed. 


This gives a useful indication of the 
maximum speed you can expect to use 
with a communications program. 
Note that it is unusual for the test to 
complete at 115,200 bps. 


Conclusions 


The design of the PC serial port 
cannot be relied upon to deliver re- 
liable communication at speeds in 
excess of 9,600 bps. It is essential to use 
interrupt drivencommunications soft- 
ware at these speeds. But factors like 
the way the software has been written 
and what other activities are taking 
place on the machine at the same time 
all have an effect on how fast a port 
willrun before overrun errors begin to 
occur. 

The lack of any buffering for re- 
ceived characters is the main reason 
for overrun errors, as the processor has 
only a very short time to respond 
when a byte is received. This is not 
easy to achieve when other software 
may disable interrupts for short 
periods, and is not helped by the 
standard interrupt level used by the 
serial ports having a lower priority 
than most other devices. 

A buffered serial port using the NS 
16550A or later UART chip is the sim- 
plest and cheapest solution to this 
problem, and has the advantage of re- 
maining compatible with a standard 
serial port for those software packages 
that cannot support it. Setting up the 
system to use a buffered serial port is 
not always straightforward, but is 
worth the effort as it should allow re- 
liable downloads at up to 57,600 bps to 
be achieved. This should be fast 
enough to satisfy most present needs. 
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Re-engineering The 
Support Team 


Setting up a new PC support department? Considering reorganizing 


your existing one? Leigh Edwards offers some advice. 


has been an enormous increase in 

the numbers of PCs within com- 
panies, yet the majority of Information 
Technology research organisations 
seem to be drawing the same conclu- 
sions: many companies, employing 
hundreds or even thousands of PCs, 
have not used them to improve the 
way their businesses operate. Hence 
they have failed to gain any significant 
competitive advantage. 

Now for the good news. This situ- 
ation is beginning to change. Some 
companies are adopting a fundamen- 
tal shift in the way their business 
operations are conducted. Organisa- 
tions are flattening their management 
structures and restructuring their 
business processes to exploit IT effec- 
tively and significantly improve 
efficiency. 

There is no evidence that the rate of 
technical progress in the IT industry 
will slow down. Unfortunately, there 
is little evidence that IT currently pro- 
vides organisations with a sustainable 
competitive advantage. Systems are 
too easily copied by competitors. The 
real benefits are derived from the con- 
structive combination of IT with an 
organisation’s structure, and with 
people who are capable of exploiting 
the information and the new function- 
ality available. For example, is it really 
important to be able to produce world 
class overhead slides for internal com- 
pany presentations? Or _ use 
word-processing and desktop pub- 
lishing to produce elegant and 
sophisticated letters and business do- 
cuments? Why not explore new, 
innovative ways of eliminating the 
need for large volumes of printed do- 
cumentation and paperwork? 

New organisations are not clut- 
tered with the baggage of old business 


[ is obvious to everyone that there 


processes and can exploit the oppor- 
tunities provided by IT to perform 
many of the basic processes of tradi- 
tional businesses in novel ways. 
Established organisations will have to 
equal or better the performance of new 
entrants in order to remain competi- 
tive. 


Hidden Costs 


It is not so long since the main- 
frame, running the company accounts, 
payroll, pensions, etc. was king, and 
the development and support of all 
other business applications were sec- 
ondary. Typically the system was 
"owned" by the accounts function and 
managed by the Information Systems 
(IS) Group. Today, individual depart- 
ments have more options and 
autonomy as far as computing goes, 
but recent research (KPMG Manage- 
ment Consulting) concluded that most 
corporates are mismanaging their PC 
support resources and are failing to 
account for the high costs of end user 
support. 

Even in organisations with for- 
malised end user support groups, the 
majority of assistance may come from 
knowledgeable end users who spend 
a lot of time helping others in the of- 
fice. Pressing problems with the 
technology are handled within the 
work group, diverting effort away 
from its primary purpose. If senior 
management fails to account for these 
hidden costs they will not be reflected 
in policy decisions. It has been esti- 
mated that an organisation with 2000 
PCs will spend over $16 million an- 
nually in direct and hidden costs on 
end user computing (Gartner Group 
Research Organisation). That’s $8000 
per PC per year. 

Some industry pundits claim that, 


if the true costs of the PCs, software, 
peripherals, support etc in a company 
are taken into account, then operating 
acentral mainframe is still a cost-effec- 
tive option. But mainframes cannot 
compete with the steady increase in 
functionality provided by the desktop 
PC. Increased functionality brings 
greater complexity which means that 
demands for support are increasing 
proportionately. Today’s average PC 
is networked and runs more than five 
applications. However, while in- 
stalled bases of PC and LAN 
technology continue to grow rapidly, 
most organisations do not plan further 
increases in the numbers of support 
staff (Nolan, Norton and Company). 

It might be argued that formalised 
support is unnecessary and that the 
user community could, and should, be 
self supporting. Future systems, with 
fault tolerance, high levels of automat- 
ion, etc. may allow this, but currently, 
IT support is an increasingly spe- 
cialised and technically complex task. 
Just as it makes economic sense to 
have a modern sophisticated car re- 
paired and serviced by specialists, so 
it makes equal sense to have PCs and 
associated networks supported by 
well trained technical staff. 

Good support may be crucial to 
business efficiency but it is not an end 
in itself. Control of support costs and 
careful direction of available resources 
is vital. Ideally, the main emphasis of 
any support group should be on those 
areas that affect the business bottom 
line, hence maximising its own effec- 
tiveness. 


Decentralisation 


The demise of large centralised In- 
formation Systems Departments has 
been predicted for some years now, 
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"Devolving IT resources has clear 
advantages to business units where 
responsiveness and specific knowledge are 
essential. Too much decentralisation can 
bring distinct disadvantages, wasting 
time and resources, by repeating work 
done by others, solving the same problem 
multiple times and lack of an overall 
company strategy and standards." 


but it would appear from a recent 
study that the change is gathering 
pace. It has been reported (Applied 
Learning International), that during 
1993, 60% of companies have re-de- 
ployed staff from IT departments into 
business areas, an increase of 12% over 
1992. The number of companies trans- 
ferring a proportion of their IT budgets 
to users increased from 30 to 50%. 
Other IT surveys from Price Water- 
house and OTR Group support these 
trends. 

A major driving force behind these 
changes, apart from the technological 
advances, has been increased IT 
knowledge within the user com- 
munity leading to increased 
dissatisfaction with centralised IT 
functions and their ability to deliver. 
Networks of PCs, running applica- 
tions designed around work group 
activities, are increasingly replacing 
the traditional mainframe applications. 

Since more responsibility for com- 
puting is shifting to business units, it 
is vital that management and users 
fully exploit the potential of IT, by 
mapping it onto their key business 
needs. Many organisations are now 
recognising that the effectiveness of 
their investment in personal com- 
puters is dependent upon their ability 
to provide training and support in a 
timely and efficient manner, thus 
maximising the pay back from the 
technology. 
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Devolving IT resources has clear 
advantages to business units where 
responsiveness and specific knowl- 
edge are essential. Too much 
decentralisation can bring distinct dis- 
advantages, wasting time and 
resources, by repeating work done by 
others, solving the same problem 
multiple times and lack of an overall 
company strategy and standards. 
Such disadvantages will make them- 
selves particularly apparent as the use 
of networking expands. There are 
clear differences between managing 
individual PCs and managing a net- 
work, where a problem can affect all 
users. 


Define Your Strategy 


Any company that aims to develop 
and expand needs a business strategy 
plan. If IT is important to that com- 
pany, it should have an Information 
Systems Strategy (ISS) that is based on 
the business strategy. A clear ISS 
makes determining support needs 
relatively easy. Defining an ISS may 
seem excessive or unnecessary for a 
small company considering compu- 
terisation, or where only a modest 
investment in PCs has been made. 
However, as previously indicated, the 
major costs of IT are the on-going 
costs, not the purchase of hardware, 
software etc. If the use and expansion 
of IT is allowed to grow in an uncoor- 
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dinated ad hoc manner, addressing 
the real support priorities and control- 
ling costs will be far more difficult. 

Customers and IT staff, working 
together on the development of an ISS 
can produce a number of tangible 
benefits. Systems are more likely to 
support the key business objectives. A 
coherent, compatible, technology 
strategy should emerge, which is un- 
likely to constrain future options, 
allowing systems to be more easily in- 
tegrated. Replacement of PCs etc and 
all future purchases will be part of an 
overall investment in an IT infrastruc- 
ture. Very new or very old technology 
can be extremely expensive to sup- 
port. It is cost effective to have a policy 
for replacing ageing technology and 
for adopting new developments. The 
organisation will be better informed 
and is able to plan, set priorities for 
projects and allocate resources. Mis- 
understandings between the users 
and the IT function or support organi- 
sation are also less likely. 


Critical Business Systems 


To focus IT effort it is important to 
critically examine each of your appli- 
cations and systems with respect to 
their relative importance and con- 
tribution to the business. For example: 


@ Support - those systems or applica- 
tions that assist the operations of 
the business but are not essential to 
its ability to function. 

Key Operational - Systems that are 
essential to the business, which it 
depends upon for its success, ie, 
applications without which the 
business could not continue. 
Strategic - Systems or applications 
that give the business a strategic 
advantage over competitors and 
may sustain future business 
strategy. 

High Potential - Systems or applica- 
tions that may be important in 
achieving future success or 
strategic advantage. 


A common situation is that most IT 
effort goes onadministrative tasks and 
"Support" category systems when the 
real payback would come from an em- 
phasis on those which are "Key 
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slightly more colloquial version of the 
same sentence (anyone who has read 
the original UNIX documentation will 
appreciate what I mean by a colloquial 
version, such as "There are some 
things you just can’t get Lint to shut up 
about"). 

Consistency is of vital importance 
throughout your document. It is a 
good idea to list the various terms that 
you will be using to describe your sys- 
tem - calling the "Main menu" a 
"Startup screen" elsewhere in the do- 
cument will confuse the reader. Try to 
write these down or keep a list on-line, 
as it can be all too easy to become 
confused yourself. Likewise, you 
should decide on standard wording 
for certain components, like cross ref- 
erences or references to figures (for 
example, "See fig 1", or "As described 
in fig 1", or "Figure 1 details..."). 


Conventions 


Early on in your document you 
must decide on and detail any conven- 
tions used to describe keystrokes, 
mouse actions and so on. It is much 
simpler to explain the term "clicking" 
once, rather than constantly repeating, 
"Move the mouse to position the 
pointer over the item and then press 
and release the left button”. It’s a good 
idea to use a different typeface or style 
to identify commands and keys. For 
example, the article that you are read- 
ing now uses the Times font. It’s 
common to use bold text to highlight 
important points and to switch to a 
font such as Courier when you want 
to tell the user to, for example, press 
the ReturnkeyortotypeCOPY LET- 
TER.DOC A. 

When designing the document, 
and choosing the fonts that you will be 
using, you may be forced to use the 
corporate standard font or page 
layouts. If you are starting a new pro- 
ject, and your company has a 
corporate design standard, ensure that 
you are allowed to deviate from the 
standard before you start doing so. 

Be consistent in your use of termino- 
logy. If you refer to the "enter" key, don’t 
call it the "return" key in the next para- 
graph. You may wish to use graphical 
symbols for the enter and cursor keys, 
but ensure that you provide a key at 
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the start of the document - you may be 
surprised at how many different sets 
of keyboard symbols there are. 


Use of Pictures 


A picture, it’s said, is worth a thou- 
sand words and many technical 
illustrators agree. While it is obviously 
important to have clear illustrations in a 
hardware-related manual, many people 
underestimate the value of good illus- 
trations in software documentation. 
Clear block diagrams of system interac- 
tions, process diagrams and even the 
venerable flow chart can make a com- 
plex system far easier to describe, and far 
easier to understand for the reader. 

For software documentation, 
screen dumps are invaluable (tech- 
niques for incorporating screens into 
your document are described later in 
this article). Try to resist the tempta- 
tion to "draw" screens, as the re-drawn 
versions rarely correspond accurately 
to the real display, and this can be a 
major source of confusion for the 
reader. Also, should the software 
change, taking another screen dump 
will only take a few minutes; re-draw- 
ing it may take much longer. 


Supplementary Information 


In addition to the mainstream in- 
formation in your document, there are 
three main types of supplementary in- 
formation that you may wish to 
incorporate, namely notes, warnings 
and cautions. Notes are used for addi- 
tional information about a particular 
area that cannot easily be incorporated 
into the general flow of text. 

Notes are often used for describing 
particular implementation issues, 
compatibility problems, or simply 
useful pieces of background informa- 
tion which simply don’t fit in 
anywhere else. Cautions are used to 
provide information that the user 
should be aware of to avoid damaging, 
the system, such as electrostatic sensi- 
tivity.Warnings are reserved for 
important information which, if ig- 
nored, could cause physical damage to 
the user, such as high voltage areas or 
dangerous moving parts (anyone 
who’s worked on an old daisywheel 
printer will know what I mean here). 
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Lists 


If you have a set of steps that must 
be followed ina particular order, such 
as a software installation procedure or 
hardware start-up sequence, use a 
numbered list. By numbering each 
step, it is clear to the reader that the 
instructions should be followed in a 
particular order. For lists that are not 
in any particular order, such as an 
overview of features or hardware re- 
quirements, use a bullet. 

Many word processors will auto- 
matically turn cells in a table, or a set 
of paragraphs, into bullet or num- 
bered lists. They will even keep the 
numbering up to date, renumbering 
the list if you insert or delete a para- 
graph. 

You will find it easier to write con- 
cise instructions in the form of a list, as 
it is simpler to string together short 
sentences in this fashion rather than 
trying to fit them into an inline para- 
graph. 

If your document contains a high 
degree of cross-referencing, as is the 
case in many software reference ma- 
nuals, you may wish to use numbered 
headings, or even numbered para- 
graphs. 

This can make cross-references 
much easier to follow, as "see section 
1.2.3" is easier to follow than "see the 
section on installation". "See page 97", 
of course, is even better, though that 
involves keeping all your cross refer- 
ences up to date. Any modern word 
processor will do that for you, and it’s 
well worth investigating the feature if 
you ve never used it before. 


Review Stages 


Documents are very rarely correct 
first time round, and in most cases 
several drafts or review stages are re- 
quired. Basically, you produce a 
document, and it is then passed to an- 
other person (or several people) for 
comment, and then you incorporate 
these comments and go around the 
loop again. To prevent a never-ending 
cycle of review and change, it is cus- 
tomary to limit subsequent draft 
comments to those made on the pre- 
vious draft - that is, at second draft, 
you will only be incorporating the 
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comments on first draft, and not any 
"new" material. 

The number of draft and revision 
stages you do will depend very much 
on the complexity of the system, but 
most documents go through three main 
drafts. The first draft is where most of 
the changes occur, such as technical 
changes, correction of omissions and 
so on. The second draft covers the first 
draft comments, and maybe a few 
other minor changes. The final draft 
covers the second draft comments, 
and final formatting changes. 

The end product is known as ca- 
mera-ready copy, which refers to the 
days when pasted-up pages, with 
stuck-on pictures and hand-cut col- 
umns of text would be photographed 
and made into a printing plate. Nowa- 
days, of course, most manuals can be 
produced directly ona laser printer or, 
via PostScript files, sent directly to a 
professional typesetting machine. 

There are several approaches to de- 
ciding who should review your 
document. For a small manual, you 
may wish to perform the review your- 
self, but this can cause problems as it 
is easy to miss your own mistakes. You 
tend to read what you think you have 
written, rather than what you have 
actually written. If at all possible, get 
someone else to review your docu- 
ment. 


Choosing Reviewers 


There are two approaches to choos- 
ing your reviewers, and as usual, you 
will probably decide on a compromise 
between the two. The first option is to 
use people of a similar technical level 
to your own. As they already under- 
stand the subject matter, the reviewer 
is ina good position to pick up techni- 
calerrors and omissions. However, for 
the same reason, they will not necess- 
arily be able to judge whether the 
technical level of the document is 
pitched at the correct level. The second 
option is to use members of the target 
audience. In practice, a combination of 
the two is usually the best option. If 
you are producing a small document, 
you may wish simply to release it, and 
amend it as and when users of the 
document find errors - but you should 
still check it carefully yourself. 


It is important to ensure that the 
reviewers produce concise, unam- 
biguous comments wherever possible 
- having a complex procedure simply 
marked as "Wrong!" is unlikely to help 
you much, whereas comments such as 
"Maximum length is 64 not 32 charac- 
ters" are far more useful. 

If you send out more than one copy 
of the document for review, as is often 
the case with larger documents, take 
the time to consolidate the comments 
before trying to incorporate them. It is 
common to find that each set of correc- 
tions will contradict another in some 
areas, and if you simply go ahead and 
incorporate all the comments you may 
find that it will be necessary to re-write 
the same section several times. 

When incorporating comments tick 
them off as you go, preferably in a 
different colour, to ensure that you 
catch all of them. It is all too easy to 
come back to the job the next day and 
forget how far you got with the incor- 
poration of the comments. 

Always read through the marked- 
up document before starting, as you 
will often find sets of comments that 
may be processed automatically using 
a macro or search and replace oper- 
ation. 


Marking 


All review stages should be clearly 
marked as such - ideally, put the draft 
status and date in the header or footer, 
but as a bare minimum produce a 
"cover page" with these details. 

Never, ever, delete old copies of 
documents. Before making a set of 
changes, copy the current version toa 
temporary directory so that you have 
something to go back to. This can be 
very useful if you find that your re- 
write of a certain section is not going 
well, and you want to start again with 
the original. It’s also a way of ensuring 
that, if a reviewer changes his mind 
and wants to reinstate the chapter that 
was deleted two weeks ago, you can 
still recover the text. 

Some word processors have revi- 
sion control systems built in, though 
many don’t. You can, of course, do 
things the simple way and save conse- 
cutive revisions as SWMANUAL.001, 
SWMANUAL.002 and so on. 


Layouts 


There are many different ap- 
proaches to how to lay out 
information, and it can be a very time- 
consuming exercise to get it right. As 
with writing style, always remember 
that the layout is a means to an end - 
the end being getting the information 
across to the reader. It is all too easy to 
spend hours fine-tuning a document's 
layout without improving the reada- 
bility in the slightest. The KISS 
principle (Keep It Simple, Stupid) ap- 
plies as ever, so try to keep the layout 
easy to read and use. 

Just because your printer has 35 
fonts, that doesn’t mean that you have 
to use them all. Unless you're desig- 
ning a ransom note, stick to two or 
three fonts. Remember that large sec- 
tions of bold or italic text, or chunks of 
text placed in dark coloured panels, 
will draw the reader’s eye away from 
the main body of the page so use these 
techniques only when appropriate. 

Avoid using too many gimmicks, 
such as dividing lines, borders, clip-art 
and so on. Too many components on 
the page will confuse the reader, and 
the ease with which this can be accom- 
plished using modern text processing 
software has led to the term WYSITAT 
(What You See Is Total Abscence of 
Talent) to describe such layouts. Per- 
haps the most useful element in layout 
is the least obvious - white space. 
Headings can be highlighted simply 
by leaving a few blank lines before 
them, but be careful to make it clear 
what the headings refer to (don’t leave 
too much space between the heading 
and the text to which it refers). 

Headings should stand out clearly 
from the body text - different fonts can 
be a good way of achieving this. A 
common approach is to use a different 
type of typeface, such as Helvetica for 
headings and Times-Roman for body 
text (Helvetica is a "sans-serif" type- 
face and Times-Roman is a "serif" 
typeface. Serifs are the curves at char- 
acter edges that were once caused by 
the turning of the pen or chisel, and 
lead the eye from one character to the 
next. Generally, serif fonts are easier to 
read for large quantities of text. Using 
the same font but in a larger size or 
perhaps anemboldened version is also 
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a good way of highlighting headings). 

Unless you have specific "Com- 
pany" typefaces, try to stick to the 
standard ones supplied with your 
printer. PostScript printers come with 
a selection of 35 fonts (Times, Courier, 
Helvetica etc) as standard, covering 
several different typefaces (bold, italic, 
bold-italic, condensed, wide and so 
on). This should be enough for normal 
use. If you do use non-standard fonts, 
make sure that they are freely distri- 
butable or available wherever your 
document will be printed. 

Any illustrations in your document 
should be consistently sized and 
placed. Try to keep the illustration as 
close as possible to the associated text, 
as this will make the manual easier to 
use. If your manual is double-sided, 
don’t forget that the illustration can be 
placed on a facing page, which can 
make laying out much easier. 


Binding 


Once your document is complete, 
you will need to bind the volume. 
Probably the cheapest binding 
method is the old-fashioned ring bin- 
der. Ring binding has the advantage of 
requiring no investment in specialist 
equipment (other than a hole punch), 
but can become an arduous task for 
long documents - remember that your 
local printing shop will usually drill 
the holes, saving a lot of your time. 
Alternatives include comb binding, 
spiral binding, and the perfect-bind- 
ing approach as used by paperback 
books and thick magazines. These 
techniques all require specialist equip- 
ment. Remember that almost all 
manuals end up flat ona desk, and you 
should endeavour to use a binding 
method which allows this without 
damage. Again, your local printing 
shop may be able to help with binding 
options, avoiding the cost of the bind- 
ing machinery. 

It’s a good idea to decide on the 
binding method early on, so that you 
can allow for this in the page layout 
and the margins. 


Tools Of The Trade 


The distinction between word pro- 
cessing and desktop publishing is 
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Documentation 


narrowing with every new release of a 
word processor. However, most con- 
ventional DTP packages still provide 
more comprehensive support for com- 
plex formats, picture placement and 
large document management. Word 
processors on the other hand provide 
far better editing facilities and make 
the review process much easier to im- 
plement. A common approach is to 
use a word processor to produce ear- 
lier drafts, and only go to DTP for the 
final production runs. 

Whatever system you use, try to 
use style sheets (a library of formats, 
usually stored in a separate file, and 
applied with a single operation) to en- 
sure consistent presentation. Using a 
style sheet provides centralised con- 
trol for changes, which can save hours 
of re-working when the format of your 
document changes. 

Make use of features such as auto- 
numbering, cross referencing, and the 
automatic generation of a table of con- 
tents and a subject index. 

Always use a spelling checker on 
your document, but do not religiously 
follow the suggested replacements (1 
received a press release only this week 
which informs me that OS/2 inte- 
grates senselessly with Windows). 
Spelling checkers are notorious for 
providing strange suggestions for 
slightly misspelt words. If your pack- 
age supports it, create a custom 
dictionary for project-specific terms, 
as many abbreviations and acronyms 
may be used and mistyped. 

Many word processors now incor- 
porate grammar checkers, which 
check the construction of your sen- 
tences and paragraphs against the 
rules of the English language. Such 
systems are both a blessing and a 
curse; as with the spelling checker, 
don’t follow their suggestions relig- 
iously. 


Capturing Screens 


Many software manuals will re- 
quire screen dumps, and there are 
many packages around to provide 
these. For Windows, the shareware 
PaintShop Pro provides a complete 
suite of image processing functions 
coupled with a screen grabber. Al- 
ways convert your screendumps to 
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monochrome before printing - colour 
screendumps will take much longer to 
print (as much as 30 times), and re- 
quire more storage space. Paintbrush, 
which ships with Windows, includes 
a search-and-replace facility for col- 
ours, which is useful (it’s the tool next 
to the eraser). 

If possible, use a "threshold" con- 
version, which converts each colour to 
either black or white according to its 
relative brightness. This approach can 
resultin loss of detail with some colour 
schemes, So you may have to use a 
dithering process, which will, unfortu- 
nately, degrade the appearance of the 
printed version (always try using a 
"greyscale" colour scheme, such as 
those supplied for use with plasma 
displays, as this often improves the 
quality). A good compromise in these 
circumstances is to use threshold 
dumps for drafts, and switch to full 
colour versions for final copy, as the 
printer will usually make a much bet- 
ter, but slower, job of the dithering 
process. 


Why Paper? 


There are a number of systems 
available for the electronic distribu- 
tion of documents. If your company 
has an electronic mail system, you 
might consider simply sending out the 
PostScript file via email. Adobe’s new 
Acrobat system provides very com- 
pact "Portable Document Format" files 
(a form of distilled PostScript) which 
are email-friendly and displayable on- 
screen with text searching and 
hypertext (Corel Ventura 4.2 support 
Acrobat). Acrobat viewers are typi- 
cally $35 per licence, with bulk 
discounts available. There are a num- 
ber of other on-screen documentation 
systems which are very economical 
(such as Farallon Replica, Folio Views, 
WordPerfect Envoy or the good old 
Windows help file.). 

If you are intending to use an elec- 
tronic documentation system there are 
a number of pros and cons to consider. 
Screens can usually display less text 
than an equivalent size of paper, due 
to their lower resolution. Don’t simply 
port an A4 document onto a VGA 
screen - try to take into account the size 
and shape of the display, and format 
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your document accordingly. Try to 
use the retrieval system to your ad- 
vantage, by making full use of 
machine-oriented functions such as 
hypertext, index searches and full-text 
retrieval. Remember that the machine 
should do the work when the reader is 
trying to find information. [Electronic 
documentation is a subject to which we'll 
be returning ina future edition of PCSA - 
Ed.] 


Costing 


Like any other business task, it is 
important to keep track of the cost of a 
documentation project. This can quite 
easily be performed as part of the plan- 
ning stage of the document. Once you 
have produced a synopsis, try to de- 
cide on the number of pages required 
for each major heading (don’t forget to 
allow for diagrams as well). Don’t 
worry about being too accurate - the 
idea is to get a feel for the work in- 
volved rather than to precisely predict 
the eventual size of the document. 

Next, you need to decide on what 
type of text is required - a page of 
detailed technical description will ob- 
viously take longer to produce than a 
table of contents. 

Finally, allocate hours of work for 
each page type. As a general guide, a 
preliminary page such as a table of 
contents will average at around 15 
minutes, whereas an in-depth descrip- 
tion of a software procedure might 
take up to four hours (bear in mind 
that these times incorporate the ac- 
quisition of the information, and not 
just the typing). Armed with these 
three sets of figures, you can estimate 
the number of hours required to pro- 
duce the document. 

If you have review stages in your 
document, you need to allow addi- 
tional time for these (don’t forget to 
budget for the reviewer's time as well 
as your own). Asa general rule, a typi- 
cal editorial review, involving 
technical changes, will take around 
25% of the time required to produce 
the first draft. A simple typographical 
review, with minor changes, will take 
around 5%. 

You'll also need to get details of 
how much the printing and binding 
will cost. 


Professional Printing 


If a laser printer is not sufficient for 
your needs, you can send a PostScript 
file toa bureau for output toa high-res- 
olution typesetting machine. Because 
most modern typesetters use Post- 
Script, you can print your pages to 
disk as PostScript, use the DOS COPY 
command to copy them to a laser 
printer for checking, then your bureau 
simply COPYs the same files to its ma- 
chine to produce final output. 

Of course, typesetting machines 
can increase the resolution of text but 
not, for example, that of a screen shot 
that you’ve grabbed from Windows 
via the clipboard at the standard 
screen resolution of 72 dpi. If the detail 
isn’t there, no typesetter can invent it. 
Text, though, at 2100 dpi contains 4.41 
million pixels per square inch, which 
represents a dramatic improvement 
over the 90,000 ppsi achieved by a 300 
dpi laser printer. It makes your ma- 
nual look and feel more professional. 

Expect to pay around $5 per page 
for output, which can be either to 
photographic paper (known as a bro- 
mide) or to transparent film. Many 
printing companies require film to be 
reversed, ie a mirror image. Find out 
whether yours does, before you get the 
PostScript files produced as film or 
bromides, or you risk your printer not 
being able to use them. 


Colour 


If you’re printing small quantities 
of a manual within your company, 
witha colour printer or copier, you can 
use a standard word processor to pro- 
duce coloured text and pictures. Word 
for Windows, for example, will hap- 
pily let you set the colour of text, and 
will let you grab coloured images from 
the screen and use them in documents. 

If you will be having your manual 
printed professionally, however, 
things arealot more complex. Printing 
presses build up colours on a page by 
using multi-pass techniques. Nor- 
mally there are four passes, using 
yellow, magenta, cyan and black inks. 
To produce printing film for coloured 
pages, you have to produce four sep- 
arate films for each page. Although the 
films are all physically black, each will 


be used with a different coloured ink. 

You will need special software for 
separating a coloured image into four 
separate images and producing each 
of these as a separate PostScript file. 
Word processors are not up to the job, 
and not all DTP packages can do it 
either. Ask, when buying DTP or 
drawing software, whether it can pro- 
duce colour separations. 


Summary 


By now you should have a good 
overview of the technical documenta- 
tion process, with enough information 
to provide reasonably accurate propo- 
sals and costings for your 
management. It is important to realise 
the importance of providing good do- 
cumentation - a well-written technical 
manual or a written explanation of 
how to solve a particularly common 
problem can save support staff from 
answering the same questions over 
and over, as well as improving the 
productivity of those staff who use the 
documentation. 

However, these advantages are dif- 
ficult to measure and fit onto a balance 
sheet. It is important to gain manage- 
ment backing for any documentation 
project, and this means balancing the 
cost of the document against the 
potential benefits. Hopefully, this ar- 
ticle has provided enough information 
for you to fulfil both of these require- 
ments. 


Nick Barron is IT supervi 
lar i 
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